'\" t
.\"     Title: ccn_xmltoccnb
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 11/03/2010
.\"    Manual: \ \&
.\"    Source: \ \& 0.3.0
.\"  Language: English
.\"
.TH "CCN_XMLTOCCNB" "1" "11/03/2010" "\ \& 0\&.3\&.0" "\ \&"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ccn_xmltoccnb \- convert XML into ccn binary encoded data (ccnb)
.SH "SYNOPSIS"
.sp
\fBccn_xmltoccnb\fR [\-hw] [\-d \fIdict\fR] \fIfile\fR \fI\&...\fR
.SH "DESCRIPTION"
.sp
The \fBccn_xmltoccnb\fR converts standard text\-based XML into ccn binary encoded (ccnb) form\&.
.SH "OPTIONS"
.PP
\fB\-h\fR
.RS 4
Print usage and exit\&.
.RE
.PP
\fB\-d\fR \fIdict\fR
.RS 4
Augment the built\-in DTAG dictionary with the named file (format like tagname\&.csvdict)\&. May be repeated\&. Use this if you have defined some ccnb formats of your own\&.
.RE
.PP
\fB\-w\fR
.RS 4
Toss UDATA content consisting of only whitespace\&. This is useful if there has been white space added for display purposes (newlines and indentation, for example)\&. For CCNx data (e\&.g\&. Interest and ContentObject) you probably always want this\&.
.RE
.SH "ARGUMENTS"
.sp
The named files should contain xml data\&. Use \fB\-\fR to specify filter mode (read standard input, write standard output)\&.
.SH "OUTPUT"
.sp
If not using filter mode (\fB\-\fR for the file name), the output file names are generated from the input file names, using the extension \fB\&.ccnb\fR\&. Status and diagnostic messages appear on standard error\&.
.sp
The output may be converted back into regular XML by using the \fBccn_ccnbtoxml\fR utility\&.
.SH "EXIT STATUS"
.PP
\fB0\fR
.RS 4
Success
.RE
.PP
\fBnonzero\fR
.RS 4
Failure (syntax or usage error, file not found)
.RE
.SH "SEE ALSO"
.sp
\fBccn_ccnbtoxml\fR(1)
.sp
Michael Plass <plass@parc\&.com>
